home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / hardware / scsiquery / scsiquery.readme < prev    next >
Text File  |  1999-06-14  |  9KB  |  250 lines
  1. Short:    Prints internal infos of SCSI devices
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     disk/misc
  5. Version:  1.21
  6. Requires: Os 2.04, a true SCSI-2 device (HD,CD mostly)
  7.  
  8. _____________________________________________________________________________
  9.  
  10. Changes made for 1.21:
  11.  
  12. - Disabled one error check when getting the extended inquiry data. Some
  13.   old device drivers seem to fail getting them correctly. I can't reproduce
  14.   this.
  15. _____________________________________________________________________________
  16.  
  17. Changes made for 1.20:
  18.  
  19. - Fixed a *fatal* bug that could have caused really serious crashes.
  20.   Forgot to cast correctly, leading trashing innocent memory. Outch!
  21.   *Sorry, sorry, sorry, sorry!*
  22. - Enhanced the Iomega extension output.
  23. _____________________________________________________________________________
  24.  
  25. Changes made for 1.19:
  26.  
  27. - Made the defect list format selectable, with autoselect for Iomega.
  28. - SCSIQuery prints now the extended INQUIRY data.
  29. - SCSIQuery detects now automatically whether a device name or a DOS
  30.   device driver is given.
  31. _____________________________________________________________________________
  32.  
  33. Changes made for 1.18:
  34.  
  35. - Added more sanity checks, fixed a possible enforcer hit. Thanks to 
  36.   Gene Heskett for reporting.
  37. - Changed the bad block default format to head/sector addressing rather
  38.   than bytes from index. This avoids trouble with Iomega devices.
  39. _____________________________________________________________________________
  40.  
  41. This tool prints all internal information of a SCSI device it can hold
  42. of, including the mode pages and the bad block lists. This might be 
  43. interesting for developers of SCSI software and hardware.
  44.  
  45. SCSIQuery replaces the older ProbSCSI which doesn't seem to run stable under
  46. certain (and in some sense broken) hardware, like the CyberSCSI device
  47. which doesn't seem to follow the RKRMs on each word. 
  48.  
  49.  
  50. Features:
  51.  
  52.     - Prints the device inquiry status
  53.     - Prints SCSI mode pages by their structure. It knowns most
  54.       HD and CD rom pages, and unknown pages are printed in hex dump.
  55.     - Prints the device capacity.
  56.     - Prints the defect list.
  57.     - Knows some Iomega extensions, most noticable for ZIP and JAZ.    
  58.       However, this is far from being complete due to the strange
  59.       information policy of Iomega.
  60.     - tested on the gvpscsi.device, the oktagon.device and the
  61.       (cyber)scsi.device. Should work on every device that follows
  62.       the RKRMs scsi.device documentations (roughly, at least).
  63.  
  64. To do:
  65.     Quite a lot, actually. However, it doesn't look I'm gonna have a
  66.     lot of time to develop this program further. It currently does what
  67.     it is supposed to do, but could do a lot better.
  68.  
  69.     - A GUI is missing. I'm just to lazy to write one in the current
  70.       state of this program.
  71.     - SCSIQuery doesn't allow to change or save the mode pages.
  72.     - Only mode pages for HD and CD are supported, no scanner/printer/
  73.       floptical and other SCSI device support. More mode pages might
  74.       be added on request.
  75.     - No LOG PAGES support yet.
  76.     - The readme is really a bit unhelpful. This program really lacks
  77.       a full detailed guide. However, lack of time... (-;
  78.  
  79.  
  80. Additional note:
  81.  
  82. Requests about what the output of this program means ARE NOT welcome. The
  83. SCSI-II specifications are available in public and they include all this
  84. information. 
  85.  
  86.  
  87. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  88.  
  89. More SCSI mode page informations. I'm able to implement all official pages
  90. of the SCSI-II specifications since I've a copy of the SCSI specifications,
  91. however, there are more, vendor specific pages I've no idea about. Getting
  92. hold of the Iomega specifications - not the output of the program - 
  93. would really, really help.
  94.  
  95. If you've ANY information about these (not the official SCSI-II pages!) 
  96. additional pages, please, please PLEASE LEMME KNOW!
  97.  
  98. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  99. _________________________________________________________________________________
  100.  
  101. Installation:
  102.  
  103.     Just copy it whereever you want to keep it. Needs nothing more.
  104.  
  105.  
  106. Synopsis:
  107.  
  108. SCSIQuery HANDLER=DEVICE/A,UNIT/N,FLAGS/N,DEFECTLIST/K
  109.  
  110.     
  111.     HANDLER=DEVICE    the name of the DOS handler controlling a SCSI    
  112.             device. DO NOT specify handlers that are not
  113.             linked to SCSI devices, this will either abort
  114.             with an error message in the best case, or crashes
  115.             the system in the worst case. You *HAVE TO* place
  116.             a trailing colon ":", e.g. "ZIP:".
  117.             Alternatively, an exec style device, it *MUST*
  118.             end with ".device", e.g. "omniscsi.device"
  119.  
  120.     UNIT        the unit of the exec device to investigate, required
  121.             if an exec device name was specified.
  122.  
  123.     FLAGS        flags used for opening the specific device;
  124.             defaults to zero and are not required in most cases.
  125.  
  126.     DEFECTLIST    the type of defect list to inquiry from the device.
  127.             Possible defect list specifiers are:
  128.  
  129.         OFF        Do not print a defect list.
  130.         INDEX        Specify defaults as bytes from an index on 
  131.                 the tracks.
  132.         PHYSICAL    Specify defaults as physical head, cylinder
  133.                 and block.
  134.         BLOCK        Specify defects as block offsets from the
  135.                 start of the drive.
  136.         DEFAULT        Use the INDEX method for all drivers except
  137.                 for Iomega devices which use the PHYSICAL
  138.                 type.
  139.  
  140.  
  141. Examples:
  142.  
  143.  
  144. To investigate your system partition, try:
  145.  
  146. SCSIQuery DH0:
  147.  
  148.  
  149. To print information about your CD ROM, try:
  150.  
  151. SCSIQuery CD0:
  152.  
  153.  
  154. To query the SCSI device connected to the "gvpscsi.device", unit 6, try:
  155.  
  156. SCSIQuery gvpscsi.device UNIT=6
  157.  
  158.  
  159. To query the SCSI device connected to the "oktagon.device", unit 0, try:
  160.  
  161. SCSIQuery oktagon.device UNIT=0
  162.  
  163. _____________________________________________________________________________
  164.  
  165. Special thanks goes to Werner Müller for testing. This program was actually
  166. written to help him finding problems in his SCSI configuration.
  167. _____________________________________________________________________________
  168.  
  169.                          The THOR-Software Licence (v2, 24th June 1998)
  170.  
  171.  
  172. This License applies to the computer programs known as "SCSIQuery".
  173. The "Program", below, refers to such program. The "Archive" refers to the 
  174. original and unmodified package of distribution, as prepared by the author 
  175. of the Program. Each licensee is addressed as "you".
  176.  
  177.  
  178.  
  179. The Program and the data in the archive are freely distributable
  180. under the restrictions stated below, but are also Copyright (c)
  181. Thomas Richter.
  182.  
  183. Distribution of the Program, the Archive and the data in the Archive by a
  184. commercial organization without written permission from the author to any
  185. third party is prohibited if any payment is made in connection with such
  186. distribution, whether directly (as in payment for a copy of the Program) or
  187. indirectly (as in payment for some service related to the Program, or
  188. payment for some product or service that includes a copy of the Program
  189. "without charge"; these are only examples, and not an exhaustive enumeration
  190. of prohibited activities).
  191.  
  192.  
  193. However, the following methods of distribution
  194. involving payment shall not in and of themselves be a violation of this
  195. restriction:
  196.  
  197.  
  198. (i) Posting the Program on a public access information storage and
  199. retrieval service for which a fee is received for retrieving information
  200. (such as an on-line service), provided that the fee is not
  201. content-dependent (i.e., the fee would be the same for retrieving the same
  202. volume of information consisting of random data).
  203.  
  204.  
  205. (ii) Distributing the Program on a CD-ROM, provided that
  206.  
  207. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  208. especially this licence agreement;
  209.  
  210. b) the CD-ROM is made available to the public for a nominal fee only,
  211.  
  212. c) a copy of the CD is made available to the author for free except for
  213. shipment costs, and
  214.  
  215. d) provided further that all information on such CD-ROM is redistributable
  216. for non-commercial purposes without charge.
  217.  
  218.  
  219. Redistribution of a modified version of the Archive, the Program or the
  220. contents of the Archive is prohibited in any way, by any organization,
  221. regardless whether commercial or non-commercial. Everything must be kept
  222. together, in original and unmodified form.
  223.  
  224.  
  225.  
  226.  
  227. Limitations.
  228.  
  229.  
  230. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  231. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  232. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  233. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  234. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  235. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  236. SERVICING, REPAIR OR CORRECTION.
  237.  
  238.  
  239. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  240. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  241. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  242.  
  243.  
  244.                                                         Thomas Richter
  245. _____________________________________________________________________________
  246.  
  247. And now, have fun!
  248.  
  249.     Thomas        (May 1999)
  250.